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1. INTRODUCTION. 

This manual presents the imPRESS Layout Description Language for the IMPRINT-10 Printing 
S3 r stem. 

The imPRESS language is. a powerful tool for text and graphics layout and is interpreted 
directly by the imPRESS processor, a module of the IMPRINT-10 system. 

The following features of imPRESS should be mentioned: 

• imPRESS provides a unified mechanism to deal with graphics and text. Both kinds of 
primitives can be mixed and share the same common description environment. 

o Character shapes are loaded individually on a demand basis. The concept of font is used 
only as a convenient way to group and refer to characters, but only those characters 
required to print a page need be loaded. 

s The size of shapes is not restricted, thus large figures (like logos or digitized signatures) 
do not require to be partitioned into smaller elements. 

« The number of different primitive shapes that may be printed on a page is only limited by 
the memory available in the IMPRINT-10 (which is ample and may be easily expanded). 

• Shapes are automatically rotated by the imPRESS processor. 

• The layout may be specified in any order. There is no need to presort the layout 
information. 

o The set of text primitives in imPRESS allows for extremely compact representations for 
even fully typeset text. 
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2. OVERVIEW OF THE imPRESS LANGUAGE 

The imPRESS language permits the definition of documents to be printed on any raster 
printing device, in particular the IMPRINT-10. 

Documents are defined as- sets of pages, which in turn consist of sequences of printing 
instructions. 

The shapes that may be printed are either 
predefined shapes called glyphs, 

basic graphic primitives that describe elementary surfaces, like a rectangle, a straight 
line, etc. 
composite graphic constructs, called boxes, previously defined using imPRESS. 

Glyphs maybe resident in the printing system or may be downloaded from the host computer. 
In general imPRESS assumes the existence of a glyph table, where the predefined shapes 
(characters, logos, arbitrary bit maps) are kept. Commands are provided to manage the 
space available for the glyph table. 

The impression of a glyph occurs at a point within the page called the current position. This 
point is changed ("advanced") by the printing of the glyph, or it may be arbitrarily altered 
by suitable commands. The language does not assume any presorting of the descriptions 
and thus the current position may change in any direction. 

A set of line oriented commands are provided to facilitate the generation of textual docu- 
ments. Though they do not add new descriptive capabilities the use of these commands 
result in extremely compact representations. 

The imPRESS language allows ninety degree rotations of the printing direction, thus permit- 
ing "portrait" and "landscape" modes to intermix in the same page. 

When presented with invalid descriptions the imPRESS processor will take a default action 
(like printing a warning mark on the page) and raise an error condition that will later be 
reported through the standard system error channel. 

There are two standard representations of imPRESS descriptions. The first one, textual 
representation, is intended for human consumption, to allow the user to read the imPRESS 
description of a document. The second one, compact representation, is an efficient encoding 
of imPRESS descriptions, intended mainly for computer storage and transmission. The 
translation between textual and compact representations is straightforward. 
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3. BASIC CONCEPTS. 



The imPRESS environment. 

The imPRESS language describes documents as a set of boxes that will be printed on a 
sequence of pages. 

A box is the description unit. Once it has been described it may be positioned anywhere 
in the output, and in any of the allowed rotations (please see below). The box may also be 
replicated as needed. 

The commands define box and set box are intended for the definition and printing of a box 
respectively. 

The description of a box refers to a certain environment. Also the description process may 
alter the environment using appropriate commands. The environment essentially defines: 

the coordinate system with respect to which the different graphic elements are posi- 
tioned, 

a roving pointer onto the box (the current position) and 

a set of global parameters that are implicitly referred to by various commands, thus 
yielding more concise representations. 

Two commands, save environment and restore environment, facilitate manipulating the 
environment within different levels of a description. 

Symbols, characters, fonts. 

We will call symbol any particular shape that has associated with it a well known meaning. 
For instance the letter "a" , or the greek letter "7" or the symbol "$" . 

In order to print a symbol its shape must be further specified, in particular its typographic 
style and its dimensions. So the customary procedure has been to group certain symbols 
represented in some common style in a font, and refer to each one of them by an associated 
character index. Thus within an imPRESS description a character is referenced by stating 
the font where it belongs and the corresponding character index. 

A font must be "introduced" to the imPRESS processor before any of its characters may be 
used. This is accomplished by a font declaration command that associates with it a font 
index, which is valid throughout the printing job. 

Font and character residence. 

The imPRESS processor requires each individual character that has been referenced in a page 
to be accessible at the time the page is printed. Notice that there is no requirement at the 
font level, only those characters that are used must be present. 

Some fonts are stored within the IMPRINT-10 controller (for instance in PROM, or in local 
mass storage) or are accessible through a well defined protocol (as in the case of a local 
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Illustration 1: 

The Coordinate System. 



network), these fonts are called resident. On the other hand external fonts reside on the host 
that submitted the printing job. 

Resident fonts have a font name associated with them. For the usual fonts that name 
identifies the typographical style and the nominal size of the font. 

In general, when a character that belongs in a resident font is mentioned, the imPRESS 
processor will take care of accessing it. Otherwise the printing job must contain a character 
definition command. (The latter is the mechanism provided in imPRESS to "download" a 
character from the host to the IMPRINT-10.) 

Current position, coordinates, dimensions. 

Commands in imPRESS refer to positions within the box being described. Positions are pairs 
of coordinates: horizontal and vertical. We will denote coordinates with the subcripts h (for 
horizontal) and v (for vertical). (Please see illustration 1.) 

Coordinates are referred to a system that may have its origin in any of the corners of the 
box (the specific corner depends on the rotation as we shall see later). 

A box has four corners: NW, NE, SW and SE. The box width is the distance between NW 
and NE (as well as between SW and SE). Similarly the box height is the distance between 
NW and SW (or NE and SE). 

Both coordinates and dimensions are signed quantities and are measured in pixels both in 
the horizontal and vertical directions. 

The current position is a distinguished point within the page: it specifies where the next 
figure is going to be printed and is the basis for most position computations in imPRESS. 
Also the printing actions modify the current position in the "expected" way, thus yielding 
very compact representations. (For instance text may be specified with almost no extra 
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Illustration 2: 

Figure Dimensions. 



positioning commands.) The symbol C will stand for the current position, and Ch and C v 
will refer to its horizontal and vertical coordinates. 

Primitive figures. 

The imPRESS language recognizes basically three different classes of figures that may be 
imprinted on a page: 

Glyphs: a shape represented by means of a bit map. This category includes characters, 
logos, digitized signatures, etc. 

Graphic primitives: each primitive represents a family of surfaces (lines, polygons, etc.). 
In each case, a set of parameters allows to choose the individual surface to be printed. 
Boxes: previously defined composite figures. 

Figures have a set of dimensions and points (please see illustration 2) associated with them: 

A reference point (R) used to position the glyph. 

A width (w) of the mask. 

A height (h): vertical distance from the mask topline to the reference point. 

A depth (d): vertical distance from the mask bottom line to the reference point. 

A line offset (/) that relates the reference point to the current position when the glyph 
is printed. 

Nominal height(rc/i) and nominal width (nw) define the change in the current position 
after the glyph is printed. 

The corner points TopL, TopR, BotL and BotR delimit the glyph mask. 
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Figure printing. 

Figures are overlaid (a logical "or" operation) onto the page. No restrictions apply about 
superimposition, so that many figures may overlay the same pixel. 

When a figure is printed, its reference point is made to coincide with the current position. 
After printing the current position is altered (according to the nominal dimensions of the 
figure) if the advance mode in the environment is set to "advance" . 

The overlay process may be described as follows: 

1. A figure is set so that its reference point R coincides with the current position C. 

2. The figure mask is then overlaid ("ored in") onto the page. 

3. If the advance mode is "advance" then the current position is altered by adding the 
glyph nominal dimensions to it: 

Ch "- C h -\-nw 
C v *- C v -\- nh 

Notice that as a result of the above rules it is very simple to describe different ways of 
printing. For instance fixed and proportional spacing are trivially represented if the nominal 
widths of characters within fonts are properly chosen, or right to left printing is automatic 
using negative nominal widths. 

Changing layout orientation 

So far nothing has been said about the actual orientation of the coordinate system with 
respect to the box. 

Throughout a box description, the coordinate system should be seen as having its horizontal 
axis going from left to right and the vertical axis going from top to bottom. What this 
means is that in the case of latin alphabets, characters should be printed along increasing 
values of the horizontal axis, and a new baseline should be at a larger value of the vertical 
coordinate. 

Figures are always set oriented along with the coordinate system (that is, the TopL corner 
point is set at the smallest h and v coordinates). Any required rotation of the figure is 
performed by the imPRESS processor. 

At the beginning of the description the coordinate origin coincides with the NW corner of 
the box. In order to change the printing orientation imPRESS provides the command rotate. 
This command essentially affects the position of the the box with respect to the coordinate 
system, while leaving the current position C stationary with respect to the box. 

The rotation itself can be relative (clokwise or anticlockwise) or absolute within the box 
(specified by selecting the corner for the coordinate system). 

Illustration 3 shows the effect of various rotations: 

(1) With the box in its initial state, the symbol "|" is set at the current position. 
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(2) After that a rotate clockwise command is issued. The current position now coincides 
with the (rotated) "|". A set position command changes the current position and a "||" 
is set. 

(3) Another rotation, another change of position and a "|||" symbol. 

(4) Same as before, but a "j|||" is set. 

Also if the box had not been rotated before the above example, the initial coordinate system 
would be at NW, and the first rotate would have been equivalent to a "rotate to NE" 
command, the second one to a "rotate to SE", etc. 

The imPRESS processor effects the necessary computation of absolute coordinates within 
the page and the glyph mask rotations that may be needed for the actual printing task. 
Descriptions are always done in a "horizontal" fashion, and the imPRESS processor takes 
care of details, so that for instance advances along a baseline occur in a "natural" way, 
regardless of the box orientation. 

Representation of glyphs. 

A glyph is defined by its dimensions and its mask. Glyph masks are represented in two 
alternative ways: encoded or as a raster map. 
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Rlustration 3: Rotations and Box Orientation. 
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Encoded masks represent dot patterns in a highly compact form that the imPRESS processor 
expands into a raster when the glyph is referenced. This is the standard representation of 
the fonts provided by IMAGEN . 

User defined glyphs are represented as raster maps. 
Boxes and Pages. 

As we have seen imPRESS creates descriptions of boxes. These descriptions are position and 
rotation independent, in the sense that a box so described may be set anywhere in a page 
(or another box, for that matter) in any of four possible orientations. 

In order to store a box description a define box command is provided. This command 
associates a name to a box for further reference. 

Another command, set box, replicates an already defined box. The replication simply 
substitutes the box definition for the set box command. 

At definition time the environment is assumed to start with the coordinate system at the 
NW corner of the box. No assumptions are made about the rest of the environment (current 
font, line parameters, etc). On the other hand a box is set with its NW corner coinciding 
with the current position, and it is oriented so that its width and height lay in the increasing 
directions of h and v respectively. In this manner, the basic contents of a box may be 
provided at definition time with final details (position, orientation, etc.) provided when the 
box is set. 

Finally imPRESS provides a mechanism to actually define the pages to be printed. The 
command page is essentially similar to a box definition but instead of storing it submits the 
definition of the page contents to the IMPRINT-10 Printing Module. 
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4. DESCRIPTION OF imPRESS. 



An imPRESS description is a sequence of commands and glyph and graphic primitive references. 
Commands specify changes to the environment while the references indicate the print- 
ing of a given glyph or graphic element. 

Representation issues. 

There are two alternative ways to represent a given imPRESS description: textual and 
compact encoding. Both representations are exactly equivalent as far as their descriptive 
power, but they differ in their intended use. The first one is intended as a human readable, 
easily portable encoding, while the second one is better suited for storage and host to 
1MPRINT-10 communication purposes. 

The IMPRINT-10 processor provides an utility (imPRESSDump) that prints out the textual 
representation of a compact description. 

i 

Textual representation. 

Constructs representing commands and references are made up from ASCII strings delimited 
either by spacer sequences or the two special characters command escape and command 
delimiter. 

A contiguous sequence of any of the characters "tab", "carriage return", "line feed" or 
"space" is a spacer sequence. Spacer sequences delimit parameters within commands, and 
denote the spacing command elsewhere. Please notice that the length and actual choice of 
characters within the spacer are irrelevant. 

Commands are prefixed by the command escape and delimited either by the command 
delimiter or a spacer. These special characters are user-selectable and thruout this description 
we will use the symbol "6" to denote the command and ";" for the command delimiter. A 
command may have one of the following two formats: 

command -»6<command prefix> 

command -+®<eommand prefix > <parameters> ; 

that is, the command delimiter is used only when the command has parameters. 

Numeric parameters may be interpreted as either decimal or hexadecimal values, the base 
chosen globally by the command Set Base. 

Character indexes are represented by ascii characters and/or the special construct "Q< number >' 
For instance the string 

abA03 4x 

represents the sequence of character indexes 97 (for "a"), 98 ("b"), 65 ("A") 3 (the construct 
"G3") and 120 ("x"). 

Spacers are ignored after commands, but they denote interword spacing between glyph 
references. For instance the sequence 

613 Hello there, QI1 Joe 
IMPRESS/VO/810625 



IMAGEN 


The imPRESS Language 


10 



denotes a font change (to font number 3), then the word "Hello", then interword spacing, 
then "there," another change of font (to font 1) and the word "Joe" (notice that no interword 
spacing will appear between the "," and "Joe" since the spacer after "Of 1" is ignored). 

Compact encoding. 

The compact encoding represents an imPRESS description as a sequence of eight bit bytes. 

Commands consist of a command prefix and parameters, if any, follow in predefined order. 
A command prefix is a byte between 128 and 255. 

Numeric parameters are represented as binary integers, packed in 8 or 16 bit sequences (a 
byte or a doublebyte respectively). When a signed quantity is specified, the integers are 
taken in two's complement representation. 

Thruout this manual the notations [number] 6 te and [number] 26 tes denote the 8 and 16 bit 
representations of the quantity number, respectively. A doublebyte sequence encodes the 
most significant byte first. The notation [string]*^*™" denotes a sequence of bytes. 

Character indexes are denoted by bytes between and 127. 

The Environment. 

The environment consists of the following variables: 
Ch, C v : current position. 
boxuridth, boxheight box dimensions. 

rotation: selects one of the four coordinate systems associated with the box. 
Curfont current font. 

margin, bskip and spacing: for line oriented commands. 

advancemode: selects automatic advance of the current position by the nominal dimen- 
sions. 

At the beginning of an imPRESS description the environment is initialized in the following 
manner: 

C h <-0 
C v *-0 
boxwidth, boxheight +- page dimensions 
rotation +- NW 

Curfont <- fontid 0, (corresponds to the standard resident ASCII font) 
margin, bskip, spacing ■*- suitable values for font 
advancemode «- advance 

Whenever a Set Box or Page command is executed, a new environment is created as follows: 

C h <-0 
C v +-0 
boxwidth, boxheight «- box or page dimensions 
rotation *~ NW 
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with the coordinate system changed as explained in the subsection Boxes and Pages. The net 
result is that the current position and orientation remain unchanged, but they are referred 
now to the new box coordinate system. 

The environment is saved and restored from an environment stack by the following com- 
mands. 



Command 


Save Environment 


Effect 


Saves the current value of the environment variables on the en- 
vironment stack. The values of the variables is not affected. 


Textual 
Encoding 


©push 


Compact 
Encoding 


[128] 6yie 




Command 


Restore Environment 


Effect 


Pops the value of the environment variables from the environ- 
ment stack. If the stack is empty, the variables are set to the 
initial values presented above. 


Textual 
Encoding 


Qpop 


Compact 
Encoding 


1^%U 



Example: The sequence 

014 ep =200 =100; 

Opush 

012 Oh 200; This string is set in font 2 

©pop 

This one in font 4 

sets the environment to font 4 and position <200,100>, then saves it and proceeds to modify 
it to font 2 and position <400,100> where it prints the string This string is set in 
font 2 using font 2. Finally the environment is restored to its first value so that the string 
This one in font 4 is printed in font 4 at position <200,100>. § 



Character Reference. 

In order to reference a character the appropriate font must be selected as current font, then 
the corresponding character index will set the character. 
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Command 



Effect 



Textual 

Encoding 



Compact 
Encoding 



Set Font <fontid> 



Sets Curfont to fontid. (0 < fontid < 255) 



QKfontid> 



(No space between Of" and fontid) 



[180+14 w e 



byte 



for < n < 31 

for 32 < n < 255. 



The fontid must correspond to a declared font, otherwise the Undefined Font error condition 
is raised. 

Notice that the compact encoding reserves 32 one byte commands for the most frequent font 
settings. 



Command 



Effect 



Textual 

Encoding 



Compact 
Encoding 



Reference Character < index > 



Prints the character index within the current font. Advances the 
current position according to advancemode. 



Any ASCII character (excluding spacer characters and command 

prefix), or 

0<numeric representation of index> 



[index] 



byte 



for < index < 127. 



When using textual encoding, although non-printable ASCII characters will make the in- 
tended reference, it is advisable to substitute the construct Q<indes> to improve readability. 

Font Declaration. 

A font declaration associates a set of properties with a font. These properties refer to the 
font residence (resident or external), the character size (normal or big font) and the mask 
encoding (raster map or encoded masks). 

Properties are encoded as strings of ASCII characters, with the following meaning: 

s (small font): the maximum dimension of any of it characters is less than 127 (absolute 
value). 

b (big font): At least one dimension of one of it characters is greater than 127 (absolute 
value). 

e (encoded masks): glyph masks are encoded. 

r (raster map masks): glyph masks are represented as raster maps. 
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Command 


Font <fontid> < properties > <fname> 


Effect 


Associates the font identifier fontid with the font name /name 

and the property list properties. 

If /name is null then the font is assumed to be external, else it is 

associated with the resident font identified by /name. 

Font identifiers range < fontid < 255. 


Textual 
Encoding 


©font <fontid> <propertles> <fname> ; 


Compact 
Encoding 


[163]„ ff [fortid]^, [properties]^-" [*,»} by t e 



The font name identifies a resident font. In general the font name is the concatenation of 
an abbreviation of the typographic style of the font and its nominal size. 

Example: The commands 

Qfont 1 se courier/10; 
©font 7 sr; 
©font 4 be logos; 

declare font 1 to be a resident font (size small, glyph masks encoded) named courier/10 
(most probably a version of the courier typeface, in 10 point size). Font 7 is external, small 
and its masks are represented as raster maps. Finally font 4 is a big font, resident and 
encoded, named logos (a font containing digitized logos?). | 

For more details about fonts please refer to "IMAGEN FONT MANUAL" (imagen publi- 
cation FONT/MAN) 

Changing position. 

A change quantity is either an increment or an absolute coordinate. Both affect the current 
position in the obvious way. 

Both coordinates and dimensions are measured in pixels and are signed quantities. 

In textual representation operands representing changes to the current position are denoted 
as follows: 

absolute changes -*■== <number> 

relative changes -f<number> 

In compact representation, a change of magnitude c is represented as: 

absolute change(c) = 2.c 
relative change(c) = 2.c + 1 

that is, the magnitude is shifted left one bit, and a least significant is added to identify 
whether the change is relative or absolute. 
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Command 



Effect 



Textual 
Encoding 



Compact 
Encoding 



Command 



Effect 



Textual 

Encoding 



Compact 
Encoding 



Set Position < horizontal change> < vertical change> 



Alters the current position according to the changes. 



Op horizontal change> <vertical cnange> ; 



I 164 We [[horizontal change]] 2iyt „ [[vertical change]] 262/Je 



Command 


Set Horizontal Position < horizontal change> 


Effect 


Alters Ch according to horizontal change 


Textual 
Encoding 


9a horizontal cliange> ; 


Compact 
Encoding 


If the change is a small relative change: \incrernent\ < 127 then 

[MShyte [' ncrem ent] 6yte 
otherwise: 

[ 166 l^ e [[horizontal change]] 26yte8 



Set Vertical Position < vertical change> 



Alters C v according to vertical change 



©v <vertical change> ; 



If the change is a small relative change: \increment\ < 127 then 

l 167 hyte [increment] fcyte 
otherwise: 

l l68 ]byte [[vertical change]] 2iytM 



Example: The following commented sequence shows the changes in the current position: 
Op =100 =150; C =< 100,200 > 

Sp =19 20; C =< 19,170 > 

@h 91; C = < 110,170 > 

Qv =2500; C =< 110,2500 > 

Qv -1000; C=< 110,1500 > 



Advance policy. 



The following two commands switch the value of advancemode. 
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Command 


Advance 


Effect 


Sets the advance policy to advance the nominal dimensions of 
the figures to be printed. 

advancemode +- advance 


Textual 
Encoding 


Oadv 


Compact 
Encoding 


[U%u 



Command 


No Advance 


Effect 


The current position is not altered by the printing of figures. 

advancemode '*- noadvance 


Textual 
Encoding 


©noadv 


Compact 
Encoding 


[170]„ t , 



Line Oriented Commands. 

For typical printing jobs these commands are intended to act as shorthand for usual sequences 
of instructions. 

The line parameters are: 

margin: starting horizontal coordinate for a line, 
spacing: usual distance between words. 
baselineskip: usual distance between baselines. 

(See illustration 4). 

Two commands set the line parameters: 



Command 


Set Spacing <spscesize> 


Effect 


Sets spacing *- spacesize 


Textual 
Encoding 


9sp <spaceslze> ; 


Compact 
Encoding 


l 17 %te [ s P acesize We 
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Illustration 4: The line Parameters. 



Command 


Set Line Parameters <newbskip> <newmargin> 


Effect 


Sets bskip *- newbskip and margin <~ newmargin. 


Textual 
Encoding 


Qline <newbskip> <newmargin> ; 


Compact 

Encoding 


[172] 4j , te [newbskip]j y(e [newmargin] 26ytcs 



Two commands change the current position according to the line parameters: 



Command 


Space 


Effect 


Advance in the horizontal direction by spacing: 

Ch *~ Ch + spacing. 


Textual 
Encoding 


A spacer sequence, or 
@<spacer sequence> 


Compact 
Encoding 


nm by u 
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Command 


Newline 






Effect 


Increment the vertical coordinate by bskip: C v «- 

and 

set the horizontal one to margin: Ch *- margin. 


C v + bskip, 






Textual 
Encoding 


On 






Compact 

Encoding 


[Mhyte 





Example: The following sequence 

©line 30 20; ®sp 11; 
Op =40 =200; 

(1) The first line of the paragraphQn 

(2) the second lineta 
8t 5; 

(3) This line Is 5 units lower that the usual baseline skip. 

(4) hare Qf3 the font changesQf2© and changes again 

shows a typical paragraph set using the line oriented commands. The baseline distance is 30 
pixels except between lines (2) and (3) where it has been incremented by 5. The margin is 
set at h = 20. Line (4) shows an instance of the 0<spacer> command used to force spacing 
after the 012 command. I 



Rules. 

A rule is a black rectangle of height h and width w and a vertical offset voff. A rule has a 
nominal width equal to width. 



Command 


Rule <height> < width > <voff> 


Effect 


Prints a rule of the given dimensions. 


Textual 
Encoding 


Oru <helght> <width> <voff>; 


Compact 
Encoding 


[17%te [height]^ te [mdth] byte [vo% yte 
for small rules, or 

l 176 ]byte l^S^hbytes [ width ] 2 6yf eS i Voff lbyte 

for bigger rules. 



Illustration 5 shows the positioning of different rules. Notice that the vertical offset allows 
for easy under/overlining of figures. 

Rotation. 

Assume that a box of height ht and width wd is set at the current position. This setting 
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implicitly defines its four corners (and the four associated coordinate systems) as follows: 



NW=< C h ,C v > 
NE=< C h + wd,C v > 
SE — < C h + wd, C v + ht> 
SW=< C h ,C v +ht > 



The rotation command chooses the coordinate system in either of two ways: 



absolute rotation: select NW, NE, SE or SW. 



relative rotation: move the box in a clockwise or anticlockwise ninety degree rotation. 
(In clockwise sequence NE follows NW, SE follows NE, etc.) 



J K 



voir 



w 



-> 



jk — m 



v. 



voff 



w 



-> 



V- 



voff 




Blustration 5: Positioning of rules. 
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Command 


Rotate < new rotation > 


Effect 


Chooses one of the four coordinate systems associated with the 

current box: 

rotation *- newrotation 

Ch,C v •*- transformed coordinate values 


Textusl 

Encoding 


Qrot <newr> ; 

where <newr> is "+" (clockwise), "-" (anticlockwise), 
or NW, NE, SE or SW. 


Compact 
Encoding 


with ntwr — 0, 1 for clockwise, anticlockwise rotations 
newr = 2,3,4,5 for rotate NW, NE, SE, SW. 



The current position remains stationary with respect to the box, and thus itscoordinates 
values change when a rotation occurs. For instance if the current position under rotation 
NW is C — < h,v >, within a box of dimensions ivd and ht the following table shows the 
changes in C when the box is rotated: 

C NE = < v,wd — h >, (rotation to NE) 

Csw — < ht — v,h >, (rotation to SW) 

C SB =< wd~ h,ht— v >, (rotation to SE) 

Glyph downloading. 

The Glyph command defines a new glyph that is added to the glyph table. The command 
parameters are: 

glyph id: font fontid, character index char. 

glyph dimensions: width w, height h, depth d and nominal width nw (all of them in 

pixels) 

mask: this parameter varies depending on the glyph encoding. Please refer to the 

IMAGEN FONT MANUAL for more details. 



Command 


Glyph <glyphid> <dimensions> <mask> 


Effect 


Adds the glyph glyphid to the Glyph Table. 


Textual 
Encoding 


Qgly <fontid> <char> <w> <n> <d> <nw> <mask> ; 


Compact 
Encoding 


[178] 6j , ee [fontidJ 6yte [ch3r} byte [w] 6yt< [h] byte [d) byte [nvi] byte 

[maskCgH 1 ;' for smail fonfcs - 
l 17 %te Ifontidl ftjr(e [char] 6j , ie H 2byte8 M 2bytes [d} 2byte8 [™} 2bytes 

[™<y b 7tT ^r big fonts. 
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Glyph Memory Control. 

The Glyph Memory Area contains glyphs that have been referenced and/or downloaded from 
the host. Documents that require a large number of different glyphs must include control 
information for the imPRESS processor to delete unused glyphs in order to make room for 
incoming ones. 

The following commands control the memory allocation in the glyph table. 



Command 


Delete glyph <char> 


Effect 


Deletes the glyph corresponding to the character index char (in 
the current font) from the glyph tabie. 


Textual 
Encoding 


©del <char> ; 


Compact 
Encoding 


l l79 ]byte ( char W e 




Command 


Forget font <fontid> 


Effect 


Deletes all the glyphs for the font, and releases the fontid to be 
used in another font declaration. 


Textual 
Encoding 


@dfnt <fontid> ; 


Compact 

Encoding 


[lB0] byte [fontid],,,. 



Box Definition and Replication. 

A box has a bos name, box dimensions (height and width), and a box body (the sequence of 
imPRESS commands that describe the box). 

A box is defined by issuing a Define Box command, then the box body and finally an End 
Definition command. 

Box definitions are kept thruout the whole imPRESS description. Box definitions are not 
allowed to nest. 



Command 



Effect 



Textual 
Encoding 



Compact 
Encoding 



Define Box <name> <dimensions> 



Begin the definition of the box <name> 



GBox <name> <width> <height> ; 



[181] 6yte [name] fl/6jrt „ ["."hyte E width ] 2 ^ s [ ne 'g nt We 
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Command 


End Box <name> 






Effect 


The box <name> is defined. (The name must match the pre- 
vious Define Box command.) 






Textual 
Encoding 


Send <name> ; 






Compact 
Encoding 


[182] Me [nameQX" [V].,„ 





When a box is replicated with a Set Box command the following process takes place: 
(i) A new environment is created: 

C h *-Q 

boxwidth, boxheight *- box dimensions 
rotation +- NW 
Cur font *- previous curfont 
margin, bskip, spacing +- previous values 
advancemode *- previous value 

(ii) The commands in the box body are executed. 

(iii) Once the commands have been executed the initial environment is restored and the 
current position is modified according to advancemode. 



Command 


Set Box <narne> 


Effect 


The box name is set at the current position. 


Textual 

Encoding 


©set <name> ; 


Compact 
Encoding 


miyte in-neiy^r ir} hyte 



Pages 

The command Pages is essentially a box definition (it must be matched by an End Definition 
command). 

The imPRESS processor processes the body of commands associated with the page and 
submits the result to the IMPRINT-10 Printing Subsystem, which produces the output 

The processing of a page consists essentially of: 

» Final positioning of individual glyphs and graphic primitives on the page. 
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• Checking for glyph availability: all the glyphs needed to print the page must be available 
(else an Undefined Glyph is raised). 

• Rotating the glyphs according to their final orientation. 



Command 


Page <pageid> <dimensions> 


Effect 


A page description is processed and submitted to the IMPRINT- 
10 Printing Subsystem. 


Textual 
Encoding 


QPage <name> <width> <neight> ; 


Compact 
Encoding 


[««]»„■. [n»H3S M l'.% tt l^Uytcs [height] 26yfes 



Textual Encoding Only Commands. 

These commands set parameters that control the translation of textual descriptions, in 
particular the number representation base and the command escape and command delimiter 

characters. 



Command 



Effect 



Textual 

Encoding 



Compact 
Encoding 



Set Base <newbase> 



Sets the numeric representation base. 



©base <newbase> ; 

If < new base > = "d" then numeric strings will be interpreted as 

decimal, otherwise they are assumed to be hexadecimal. 



not applicable. 



Command 



Effect 



Textual 
Encoding 



Compact 
Encoding 



Set Escapes <esc> <delimiter> 



Selects the pair of characters for command delimiting. 



Sesc <escchar> <delimiter> ; 



not applicable. 



Example: The sequence 

©base d; 
Op =10 =20; 
©esc [] ; 
[base h] 
[p =FF =10] 
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first declares base 10, and thus the current position is set to <10,20>. Then it changes the 
command delimiters to "[" and "]". The final position command sets the current position to 
<255,16>. § 
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Appendix A: ERROR CONDITIONS. 

A given imPRESS representation might cause certain error conditions. In general the imPRESS 
processor takes a standard default action and proceeds. 

Glyph Memory Overflow: 

Cause: the glyph table does not have enough room for the glyph mask. 

Action: the glyph is ignored and any further reference to it will raise the same error 
condition. 

Position Overflow: 

Cause: a glyph or a graphic primitive is positioned out of the page boundaries. 

Action: the glyph or graphic primitive is not printed (though the current position is 

advanced accordingly). 

Undefined Glyph: 

Cause: a glyph that has not been defined is referenced. 

Action: a special "missing mark" glyph is substituted for the missing glyph. 
Undefined Font: 

Cause: a font that has not been declared is referenced. 

Action: the font reference is ignored. 

Environment Stack Overflow: 

Cause: the number of ©push commands exceeds the number of ©pop commands by more 
than MXENVIRON (an imPRESS processor parameter) 
Action: the command is ignored (no save occurs). 
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